The IDLgrWindow::SetCurrentCursor procedure method sets the current cursor image to be used while positioned over a drawing area.
Obj->[IDLgrWindow::]SetCurrentCursor [, CursorName] [, IMAGE=16 x 16 bitmap] [, MASK=16 x 16 bitmap] [, HOTSPOT=[x, y]]
Unix-Only Keywords: [, STANDARD=index]
A string that specifies which built-in cursor to use. This argument is ignored if any keywords to this routine are set. This string can either be a name provided to the REGISTER_CURSOR routine or one of the following:
|
ARROW |
CROSSHAIR |
|
ICON |
IBEAM |
|
MOVE |
ORIGINAL |
|
SIZE_NE |
SIZE_NW |
|
SIZE_SE |
SIZE_SW |
|
SIZE_NS |
SIZE_EW |
|
UP_ARROW |
|
Set this keyword to a 16x16 column bitmap, contained in a 16-element short integer vector, specifying the cursor pattern. This image can be created from a string array using the CREATE_CURSOR procedure. The offset from the upper-left pixel to the point that is considered the “hot spot” can be provided via the HOTSPOT keyword.
When the IMAGE keyword is set, the MASK keyword can be used to simultaneously specify the mask that should be used. In the mask, bits that are set indicate bits in the IMAGE that should be seen and bits that are not are “masked out”.
Set this keyword to a two-element vector specifying the [x, y] pixel offset of the cursor “hot spot”, the point which is considered to be the mouse position, from the upper left corner of the cursor image. This parameter is only applicable if IMAGE is provided. The cursor image is displayed top-down (the first row is displayed at the top).
This keyword is only available on UNIX platforms.
Set this keyword to an X11 cursor font index to change the appearance of the cursor in the IDL graphics window to a glyph in this font. On non-X platforms, setting this keyword displays the crosshair cursor.
|
5.0 |
Introduced |
|
5.6 |
Added CursorName argument |